GtkGrid: Add a note about overlapping children

https://bugzilla.gnome.org/show_bug.cgi?id=669989

diff --git a/gtk/gtkgrid.c b/gtk/gtkgrid.c
index 8a96e827517de31a96a0d6e93aaa2785e84003ba..03a0976e66875caddb331786cb6177f47364b867 100644 (file)
--- a/gtk/gtkgrid.c
+++ b/gtk/gtkgrid.c
@@ -42,7 +42,8 @@
  *
  * Children are added using gtk_grid_attach(). They can span multiple
  * rows or columns. It is also possible to add a child next to an
- * existing child, using gtk_grid_attach_next_to().
+ * existing child, using gtk_grid_attach_next_to(). The behaviour of
+ * GtkGrid when several children occupy the same grid cell is undefined.
  *
  * GtkGrid can be used like a #GtkBox by just using gtk_container_add(),
  * which will place children next to each other in the direction determined